LEGAL
=====

PHP Based iTunes Library Browser
Copyright (C) 2007  Jason Barrie Morley

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.


DESCRIPTION
===========

iTunes Library allows you to display the contents of your iTunes Library online.

It uses the XML format produced by the "Export Library..." menu option in iTunes
and renders this as a table view.

In addition, each track is a clickable link to the corresponding Last.fm
(http://www.last.fm) page for the track, allowing you to preview the music.


CURRENT VERSION
===============

 0.1.0


REQUIREMENTS
============

 - PHP 4
 - md5sum
 - MySQL
 
 
INSTALLATION
============

 1) Export your iTunes Library.
 
    OS X: Select "File -> Export Library..." and choose a save location.
    Windows: tbd

 2) Open "settings.php" and fill in the database details and FULL path to where
    you intend to place your Library.xml file on your server.

 3) Upload all the files contained in the archive to the desired folder on your
    webserver.
    
 4) Browse to this location in a web browser and you should be able to view your
    iTunes Library.
    
    N.B. The first time a library is viewed, all the data has to be imported into
    the database, so it can take some time.  Plese be patient!
    
 5) To update the contents of your iTunes Library, just re-export the library and
    upload the new Library.xml over the top of your previous one.

    
DEFECTS
=======

I am not currently aware of any defects, but undoubtedly they exist.

If you find any, please drop a mail to:

    inertia@in7.co.uk
    
    
RELEASE HISTORY
===============

 17/02/2007 - Version 0.1.0

  Initial Release.
